home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 40 / Amiga Format CD40 (1999-05-11)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-06].iso / -seriously_amiga- / wb / pipecon / pipecon.doc < prev    next >
Text File  |  1999-03-24  |  17KB  |  321 lines
  1. $Ver PipeCon Documentation 1.5 (17/02/99) Ron Hackett FreeWare
  2.  
  3. Executable Version at last documentation update V1.62 (03/01/99)
  4.  
  5. INTRODUCTION:
  6. The perpose of this program was oridginally to have a more useful alternative
  7. to the usual Boot Screen utility. You know how those Pee See things used to
  8. boot before W95, screaming through all the output from the execution of
  9. CONFIG.SYS and AUTOEXEC. Well we could do that on the good ol' Amiga by
  10. simply removing all the `> Nil:' bits but nowerdays if anything goes out to
  11. the console IPrefs gets most irate because you have opened a window on an ECS
  12. screen and it can't bump the chipset into 32-bit AGA.
  13.  
  14. CONCEPTION:
  15. This is the same problem on W95 machines where all you get to see is the W95
  16. logo and that pants colour cycling bar at the bottom. Getting irate at this
  17. on my PC and harping back to the days of my Amstrad XT booting DOS 3.2 where
  18. I knew exactly what was going on, I thought 'Hummm, can't see this stuff on
  19. the Amiga any more either, and that has annoied me before now.'
  20.  
  21. I actually find that kind of junk useful, cos I can see what commands are
  22. takeing up the most time in my boot sequence and improve them (maby?) and the
  23. whole thing usually freezes for a while if it's going to crash, giving me the
  24. oppertunity to at least see just how far it definatly DID get through the
  25. boot proceedure.
  26.  
  27. I can't do much about the W95 problem, and that's my own fault for trying to
  28. use such a pants OS.
  29.  
  30. W95 side:-
  31.     If you're intereseted you can see the AUTOEXEC.BAT file by DELeting the
  32.     LOGO.SYS file in the root directory of your boot partition, but the only
  33.     way to see CONFIG.SYS without Shif-F8ing the boot and acknowleging every
  34.     line, as far as I can tell, is to edit MSDOS.SYS with the line
  35.     SPLASH=FALSE. (Make sure it is your MSDOS.SYS not MSDOS.DOS renamed!)
  36.     Note the Hidden System nature of the files protection bits. The PC
  37.     equivelent of PROTECT is ATTRIB (Attributes) and you need + and - rhs/a
  38.     instead of ADD and SUB rwedpa(h). Attrib won't set subdirectory attributes
  39.     (grumble) you need Windoze or Norton/PC Tools etc. for that!?
  40.     To get your PC to boot into DOS under W95 with NO Windoze overheads, get
  41.     hold of 4DOS or an old Norton NDOS copy and add the line SHELL=C:\4DOS or
  42.     wherever you have your alternative CLI. If you stick this under a menu
  43.     selection and have an IF on the %CONFIG% Environment variable in your
  44.     AUTOEXEC.BAT you can select DOS or W95 at boot and not have to boot Windoze
  45.     in order to re-boot in DOS mode (nice one MS >:-( ). DOS games love this
  46.     method and you can get QEMM or whatever to bump up your RAM areas :-). 4DOS
  47.     is especially recomended for Amiga DOS / Unix fans. It makes PC DOS so much
  48.     more useable! (More like Amiga DOS.)
  49.     It also uses 286 XMS swap files to keep the CLIs uasge of conventional
  50.     memory down! :-)
  51.     If you don't have any of these (NDOS.COM or 4DOS.COM) Then you can get by
  52.     for a while by setting SHELL=SINGLE in the CONFIG.SYS to stop DOS 7.x going
  53.     into W95 right away. But it dose insist you press escape to get out of it.
  54.     Again in MSDOS.SYS you can make W95 boot DOS as default shell by adding
  55.     BOOTGUI=FALSE. This is perminant and you will have to add the Win command
  56.     to your AUTOEXEC.BAT file like Win 3.xx! (If you really want it!)
  57.     You'll have to mess adout with the Registry DBLSPACE.INIs and MSDOS.SYS
  58.     to stop all the 16bit DOS stubs going in for EMM386, HIMEM, IFSHLP and
  59.     DRV/DBLSPACE drivers beaing added to any CONFIG.SYS that dosn't contain
  60.     alternatives. FE IFSHLP is onley useful in a WinDOS shell (IYKWIM) it adds
  61.     extended filenames! (Basiclly)
  62.  
  63. Back to the problem:-
  64. What I need (I thought) is some kind of console on a screen other than the
  65. public Workbench screen. Well I tried to open a Public screen and place the
  66. Shell Con onto that, and it really didn't work all that well. I thought of
  67. shoving all this info out to a file that I could look at later, but then that
  68. dosn't make booting any more interesting, and if I KNOW the machine is going
  69. to crash I'd really rather minimise the amount of HDD work it's doing at the
  70. time. I tried to get this program to work with a PIPE: stream but then I get
  71. no sensible results from LOF, not even 'Yes there is still information in
  72. the buffer for you.' actually I now realize I should have been using LOC not
  73. LOF for some wierd reason (Well, it's a buffer isn't it!).
  74. Eventually I gave up on all of that, miscarrages asside, PipeCon was finaly
  75. born.
  76.  
  77. WHAT DOSE IT DO AND HOW?:
  78. It works on three fixed files in RAM: - Con,Note and Exit. Infact it dosn't
  79. matter what you put in Exit as soon as PipeCon sees it, it will quit and
  80. remove all three files. Or any of them that have been created and are not
  81. locked or protected (see problems).
  82.  
  83. You don't even need to use the exit file since 1.1 as you can now issue a
  84. BREAK to PipeCon provided you know it's process number, (2?) You may like to
  85. look up BreakName on the Aminet! The 'exit' file remains for compatability.
  86. If no-one wants it, it may go in version 2.
  87.  
  88. The files are expected in RAM: because if your machine crashes no damage
  89. will have been done. (ie validation errors would probably occure, this may
  90. mean just a slow boot next time but it may be real BAD, in the non-80's MJ
  91. sence! :-<)
  92.  
  93. Lines read from note will come up in the Highlight colour (Currently Red?
  94. v1.4 May still change) This means you can (as do I) redirect comments from
  95. ECHOs out to the note file whilst all other StdIO is sent to Con, or you
  96. could send StdErr to Note or (and this seems a really neat idea to me) you
  97. could send the output from your fave monitor program (SnoopDOS say) to it.
  98.  
  99. Reasently I have used PipeCon to send the startup output from ADoom or
  100. AmigaDoom to it so it looks more professional and a bit more like Doom on
  101. the PC. Troble is they both send the AHI sound setup information to the Con:
  102. device in a manner not via the 'StdIO', It may be 'StdErr' I haven't checked.
  103.  
  104. Since 1.5 it has aquired a percentage bar. This wonderful feature is
  105. implemented upon the second use by means of timing the first and storing
  106. that time in s:/PipeConTime and working the percentage bar as a
  107. pecentage of the last use. It's not completely accurate but it gives you
  108. a fair idea how much longer you have to wait.
  109.  
  110. DISCLAIMER:
  111. I (the author of code and documentation of PipeCon) hear by declare that this
  112. program may and/or may not work under any cercumstance, and may cause
  113. irepairable damage whenever it chooses to any Hardware, Software and/or Data,
  114. on any system whenever you or anyone else runs it and sometimes when you/they
  115. DON'T ;-).
  116.  
  117. It may also cause any level of physical damage to any individual
  118. who posesses it (or who dosen't) ranging from a slight twinge in the back of
  119. the neck (OOoo I think I can feel one now) to a sudden and very messy death!
  120.  
  121. The Documentation provided may be extrainious, erronious, insulting,
  122. irrelevent, offencive, illedgable, incomprehendable, unintellidgable, inane,
  123. inadiquate, exasabating, infuriating, blasfimus, questionable, ponderable,
  124. pompus, prattle and/or `quite interesting and a really good read!'
  125. (preferably in a Birmingham accent) and quite honestly I don't care!
  126.  
  127. The author welomes all to enjoy this software and partake in the
  128. consiquences of executing the program, or reading the documentation, in this
  129. or any other file in the archive, or failier to read/run, disinterest in, or
  130. whilful desision against, so doing. But regrets that he cannot be held
  131. responsible for any of the above actions or consiquneces or any others not
  132. mentioned.
  133.  
  134. In other words I works for me and if it don't for you that's tough, the only
  135. thing I may (or may NOT) do if you come running to me, is rewrite the thing
  136. with a view to removing any bugs!
  137.  
  138. P.S. This is light humoured but not a joke! Do what you like with it but it
  139. it and/or you do something you didn't whant or later find undesireable I
  140. entitle you to quietly hate me and no further. Go ahead hate me, you won't be
  141. the first, and the chances that you'll be the last are slim. Just don't tell
  142. me about it unless all it would take to apeese you is a bug fix! And I can't
  143. garentee that!
  144.  
  145. BUGS:
  146. Oh, ho ho ho, yes. Bound to be... Zillions... Yes... Sorry? What are they?
  147. ... Err... Bugger knows. I just play tested the thing until it stoped moaning
  148. at me that there was a DOS failier #33 and returning 300 at me or reseting my
  149. machine. Well I do know that it still hates IPrefs, and advise you to stick
  150. that way down in the list and quit this before running it. Of course if you
  151. like you can reopen it if you don't want to move IPrefs. I did for a while.
  152.  
  153. It will get covered over as soon as Workbench opens up and you'll miss the
  154. lovely fade so I should quit some time before that. See future in
  155. 'PipeCon.History'.(<<<No longer the case (1.4) but keep the wait if you
  156. need input focus restored to the last opened window.)
  157.  
  158. Also note that if you close and re-open for IPrefs you will loose any sence
  159. from the percentage bar! You could try swapping a couple of prefs files in
  160. between!? (see how enginious I am?) I'm not actually sure if it still plays
  161. up with IPrefs infact, but I have never had a reason to move it from just
  162. before LoadWB.
  163.  
  164. This is a Basic program with NO OS calls what-so-ever (He lies. Well there 
  165. weren't till V1.6). I didn't even plan it's development (Until V1.2 ish) just
  166. kept testing until it seemed to work. It was a playtime exersise that terned
  167. out quite well. If anyone can tell me a legal OS call to find out how much I
  168. can read from a PIPE: stream then please let me know. I just kept getting that
  169. there were some 37522 bytes or so,(Not quite 32K) even if the stream hadn't
  170. been created yet! I will try a LOC check some time. (when I get round to it.)
  171.  
  172. It still dosen't try to keep the Workbench screen closed during operation
  173. and I'm still using WBClose at periods where this can't be helped. But I
  174. will get round to doing this at some stage. I know how... Honest! It just
  175. dosen't fit with the precarious nature of V1.x of this program.
  176.  
  177. FIXED BUGS: (Also see PipeCon.History)
  178. V1.0 didn't handle tab characters at all! It just produced a character 27,
  179. but a little division and modulo arithmatic fixed that. Only partially in
  180. V1.1 and then a typeo was discovered that sorted it properly in V1.2.
  181.  
  182. V1.4 Fixed a bug that allowed the errorhandler to catch its self if it
  183. produced an error in the clean up routine. Which is common as this involves
  184. deleting the temporary files. However this is achieved by turning off the
  185. error cheching after the first error is caught! This should be fixed soon...
  186. I hope! The correct method is to have a specific error handeling routine for
  187. the clean up code that reports it the clean up failes and just quits. For
  188. completeness it should attempt to recover and finnish the clean up skipping
  189. the problem section. (or the file that is locked or protected. See PROBLEMS)
  190.  
  191. V1.6 fixed planar update flicker with WaitTOF()
  192. V1.61 fixed WaitTOF() speed reduction with WaitBOVP()
  193. V1.62 fixed all user intervention except <Ctrl>C Break with WFLG_RMBTRAP so
  194. no move blank menu bar holding up the task when you hold the Right mouse
  195. button!
  196.  
  197. PROBLEMS and WORKAROUNDS:
  198.     (Not exactly bugs, just unavoidable, undesireable features)
  199. Yes I've had a fair few along the way and most have been resolved by
  200. fiddeling with my startup-sequence file(s). And mine were wierd and
  201. wonderful to begin with. (Ask Phil(see history/future plans)) To start with
  202. I had trouble getting PipeCon to not get overlayed by workbench on the
  203. opening of IPrefs... So I moved IPrefs down to just before running Workbench.
  204. This shouldn't be a problem now because a side effect of the percentage bar is
  205. that (beaing situated on a different window) the PipeCon Screen will be pulled
  206. to the front each time it is updated. (EVEN when fading out) Then I had
  207. problems with it forceing it's self to the front when I needed to input my
  208. user ID and password. (B*sterd!) so I shifted that to after PipeCon had
  209. closed. I hope to add a method of suspending updates during such periods.
  210. The thing cannot close down if one of the files is locked. Causes of this
  211. can be:-
  212.     Some program (eg. ARQ... maby other) has opened the * (default stream) as
  213.         a file and refuse to close it 'til it quits... and never quits! (Is this
  214.         my fault!!?) Don't...
  215.             Run >> Ram:Con ARQ >> RAM:Con
  216.         Instead...
  217.             Run >> Ram:Con ARQ >Nil:
  218.     MuFS has logout'ed PipeCon so it no longer ownes the files or logout'ed
  219.         CLI(1) and it no longer ownes the files or basicly the CLI making the
  220.         output is not owned by the same user as PipeCon. There are ways of
  221.         sorting this but you need to know who ownes each task and work from
  222.         there. Oh, yes... And you need to be fairly intellegent (digitally) but
  223.         if you want to use MuFS or PipeCon let alone BOTH you'd have to be. ;-)
  224.     For some strange reason you decided to Write or Delete PROTECT one of the
  225.         files during startup... Prat! DON'T DO THIS. And why would you want to?
  226.     For some strange reason you decided to LOCK the RAM: drive during
  227.         PipeCons' close proceedure. Again, Prat! Though I can see advantages to
  228.         this they arn't worth it. Unlock check the files have gone and
  229.         re-lock! (You know how to use Lock so you should know about IF EXISTS
  230.         and SKIP. Remember the BACK switch, I know It's not documented in the
  231.         3.0 DOS manual with the A4000, If you don't have an older AmigaDOS
  232.         manual get hold of Help or even a decent version of Man! TOTD)
  233.  
  234. THE AUTHOR:
  235. My Name is Ron Hackett.
  236. You can leave a message with my folks on 01 326 311 099 UK or My father at
  237. work on 01 326 373 124 UK, and you can even snail mail me at:-
  238.  
  239.     12 Mount Pleasent,
  240.     Golden Bank,
  241.     Falmouth,
  242.     Cornwall,
  243.     UK.
  244.     TR11 5BW.
  245.  
  246. E-Mail was possible but has since been denied. :~-{ This is part of the
  247. reason for the delay of the release of this software.
  248.  
  249. I'm not usually this casual a programmer and I don't want any possible
  250. future employers to get hold of this and think `what a joke coder this Ron
  251. chap is'. But it was fun to do and may be at least as much use to someone
  252. else as it is for me. BTW are there any other HBasic2 coders out there or am
  253. I the only one using this wonderful Basic language. Really it may be a bit
  254. of a shite to get all the OS calls into a Basic program but then once you
  255. have a library of some useful routines you need never worry again,
  256. encapsulation and information hideing is great and you can bet you arse that
  257. it's more reliable than Bl*tz or AM*S.
  258.  
  259. Other FreeWare by this author:-
  260. ForcePal                A simple palette forcing utility which works from an ASCII
  261.                                 prefs file.
  262. SNR                            Fast and flexible search and replace / paramitable patch
  263.                                 program. Works from DOS and comes with a script to convert a
  264.                                 directory stricture into Amiga Guide format allowing links to
  265.                                 archive listings or extraction, Image viewing etc. Great for
  266.                                 local Aminet Mirrors. Still in Beta stages should be released
  267.                                 Summer '98.
  268. RonFonts                Not very interesting except NeatNThin which will allow you to
  269.                                 read this on a Pal screen and get all the characters in. It's
  270.                                 NP and I use it to do my coding and the 9 point for Shell
  271.                                 stuff but I do have a DblPal monitor.
  272.  
  273. Shareware by the same author:-
  274. TextAdventure        <<Working title, not yet at public release. Should allow easy
  275.                                 creation of GTAs for multi-players in an old/MUD style with
  276.                                 vector based graphics real time AI NPCs etc. All OS
  277.                                 Multitasking friendly, compatible with all screen modes (and
  278.                                 I hope graphics cards).
  279.                                 Not even Beta testing yet, anyone who wants to be on the Beta
  280.                                 testing team should contact me.
  281. ARDBase                    An Amiga custom Relational Database program, should support
  282.                                 some SQL, though this really isn't my field. Still in the
  283.                                 Design stages I'm afraid, SQL coders and Database managers
  284.                                 interested in giving advice on style and structure or indeed
  285.                                 other desires are welcome to contact me. I could really do
  286.                                 with some Markett Research on this one. I just know I have
  287.                                 never seen Amiga programs which meet my requirements. They
  288.                                 all seem to be flat file.
  289.                                 
  290. Give me a card/call/mail guys, love to hear from you!
  291.  
  292.            _____
  293.           /    /|
  294.          / \  / |
  295.         /   \/  *
  296.        /     \
  297.   -----------------
  298.     () ___ ___ )(
  299.     )(  o _ o  ()
  300.     ()    -    )(
  301.     )(   (_)   ()
  302.    )() _     _ )()
  303.   )()(  \___/  ()()
  304.   ()()/\     /\)()(
  305.  ___)(  \   /  ()___   .______________________
  306. (   ()\  \_/  /)(   )     __                 /
  307. | | )( \ |0| / () | |     |_)          .    /               .
  308.                           | \ ()/|\/|\/|/@ /             . /
  309.                                           /              |/
  310.                                          ----------------o--.
  311.                                                         /|
  312.                                                        / !
  313.                                                       .
  314. THANX:
  315.     have to go to...
  316.  
  317. (Dreadnaught Diddy) Dave
  318. (Frix) Phil
  319. (Dr. Flay) Shane
  320.  
  321. For bug testing and moral support.